home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / winprogs / winsock / install.txt < prev    next >
Encoding:
Text File  |  1994-02-02  |  58.9 KB  |  1,433 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  Trumpet Winsock
  8.  
  9.  
  10.  
  11.                                    Version 1.0
  12.  
  13.  
  14.  
  15.                                 By Peter R. Tattam
  16.  
  17.  
  18.  
  19.                     Managed by Trumpet Software International
  20.  
  21.  
  22.  
  23.  
  24.                     Copyright (C) 1993,1994 by Peter R. Tattam
  25.  
  26.                                All Rights Reserved
  27.  
  28.  
  29.  
  30.                                         2
  31.  
  32.  
  33.             Introduction
  34.  
  35.             Thank you for using  the Trumpet Winsock.   It is through
  36.             the kind  support of  many users  out there  that quality
  37.             networking software  has  been  available  at  affordable
  38.             prices to the Internet community. The  Trumpet Winsock is
  39.             a Windows  Sockets  1.1  compatible  TCP/IP  stack  which
  40.             provides a standard networking layer for many Windows(tm)
  41.             networking applications  to use,  and has  itself  been a
  42.             major vehicle  in  achieving  widespread  use of  Windows
  43.             Sockets 1.1.   The  product is  a shareware  item  and as
  44.             such, you are permitted to evaluate it for a period of 30
  45.             days.   If  you  are  satisfied  with its  usefulness,  a
  46.             registration form is provided which you  can fill out and
  47.             send to Trumpet  Software International.   A registration
  48.             fee is requested to maintain the  development and support
  49.             of this software.   Suitable arrangements  have been made
  50.             for site licenses,  and details can  be found in  a later
  51.             section.
  52.  
  53.             Disclaimer & Copyright
  54.  
  55.             These programs are  Copyright (C)  1991-1994 by  Peter R.
  56.             Tattam,
  57.             All Rights Reserved.
  58.  
  59.             They  are  provided  as  shareware   with  the  following
  60.             limitations:
  61.  
  62.                  These programs  are shareware  and are  not to  be
  63.                  resold or distributed for sale with other programs
  64.                  which are for sale.  There is no warranty or claim
  65.                  of  fitness  or  reliability.  The  programs   are
  66.                  distributed AS IS, and as such neither the author,
  67.                  nor  Trumpet   Software  International   nor   the
  68.                  University of Tasmania  shall be  held liable  for
  69.                  any loss of  data, down time,  loss of revenue  or
  70.                  any other  direct  or indirect  damage  or  claims
  71.                  caused by these programs.
  72.  
  73.             Instructions for Installing the Trumpet Winsock.
  74.  
  75.             The Trumpet Winsock  will only run  on your PC  under the
  76.             following conditions.  You  must  have  either  a  packet
  77.             driver available for use  by network programs,  or if you
  78.             wish to  use  SLIP, a  free  comms  port.   Additionally,
  79.             packet drivers can  only be used  reliably under enhanced
  80.             mode using WINPKT.   Standard mode can be  used, but care
  81.             must be taken to avoid system crashes.   NDIS and ODI can
  82.             be used via  packet driver  shims, but  their use  is not
  83.             supported.  PKTMUX  may also  be used instead  of WINPKT,
  84.             and must be version 1.2c  or later, but again  its use is
  85.             not supported.
  86.  
  87.             If you  already  have  some  kind  of  TCP/IP  networking
  88.             package installed,  it is  most likely  that  the Trumpet
  89.             Winsock will not  run and you  will have to  massage your
  90.             system configuration  to  install  the  Trumpet  Winsock,
  91.  
  92.  
  93.  
  94.                                         3
  95.  
  96.  
  97.             possibly  even  to   the  extent  of   uninstalling  that
  98.             networking  package.    Alternatively,  there  may  be  a
  99.             Winsock available  for  your package  in  which case  the
  100.             Trumpet Winsock will not be required.
  101.  
  102.             Installing Trumpet Winsock over Packet Driver.
  103.  
  104.             Firstly, if you don't know what a packet driver is, it is
  105.             normally a small piece of software  which sits in between
  106.             your network card and  your TCP program.  This provides a
  107.             standard interface  which  many  programs  can  use in  a
  108.             similar manner to BIOS calls using software interrupts.
  109.  
  110.             Why is it called a packet driver?  This is because modern
  111.             networks send  information using  packets  of information
  112.             rather than sending information one byte  or character at
  113.             a time.    For  example,  Ethernet  sends information  in
  114.             frames of up to 1514 bytes long.   The reason for sending
  115.             things in packets is that information  can be transmitted
  116.             much more efficiently in packets.
  117.  
  118.             Central to the concept of the packet driver is the vector
  119.             which is used to  communicate with it.   The 80x86 family
  120.             of processors  allows  programs to  communicate  with the
  121.             operating system  through  what  is  called  a  "software
  122.             interrupt", which always has  a number in the  range 0 to
  123.             255.  This is termed a "vector" and is the one of the key
  124.             mechanisms  to  pass  control  to  the  MS-DOS  operating
  125.             system.  Usually  the vectors are  in hexadecimal, making
  126.             the range expressed as 0x00  to 0xFF. The 0x  in front of
  127.             the number means  that we  are using  hexadecimal numbers
  128.             instead of decimal numbers.   They may  also be expressed
  129.             in the notation  00H to FFH,  or $00  to $FF. If  you are
  130.             dealing with packet drivers, hexadecimal notation is much
  131.             more common,  but  occasionally  they  are  expressed  in
  132.             decimal.  Examples of software interrupts  in use on PC's
  133.             are 0x10 for the video BIOS, or 0x21 for calls to DOS.
  134.  
  135.             Packet drivers  are  only  allowed  to  have  a  software
  136.             interrupt vector in the range 0x60 to 0x7F. Normally, you
  137.             will pick  0x60  as the  default  place  to install  your
  138.             packet driver,  but  certain  machine configurations  may
  139.             make that  vector unavailable.  Just choose  one  that is
  140.             free - the packet driver  should tell you if  you can use
  141.             it or not.
  142.  
  143.             The Trumpet Winsock  also uses  a special  virtual packet
  144.             driver "wrapper"  which  enables  your  packet driver  to
  145.             function correctly in  Windows.  While  the packet driver
  146.             is an  efficient  way to  communicate  with your  network
  147.             card, it will not  work correctly from  Windows without a
  148.             little assistance.   The program "WINPKT"  was written by
  149.             some clever  people on  the  Internet to  allow  a packet
  150.             driver to work  correctly within  Windows by  making sure
  151.             that  packets  get  directed  to   the  correct  "virtual
  152.             machine"  under  Windows  enhanced  mode.     A  "virtual
  153.             machine" can be either the entire Windows session, or any
  154.  
  155.  
  156.  
  157.                                         4
  158.  
  159.  
  160.             dos session active within Windows.   Refer to the Windows
  161.             system documentation for more details.
  162.  
  163.             In  addition  to  this,  you  will   need  to  have  some
  164.             understanding of IRQ  vectors and I/O  addresses that may
  165.             be relevant to installing your network card.
  166.  
  167.             Where do I obtain packet drivers from?
  168.  
  169.             These days, packet drivers are usually provided with your
  170.             network card,  but a  comprehensive collection  of public
  171.             domain packet driver can be obtained from a packet driver
  172.             collection called the "Crynwr  Packet Driver Collection."
  173.             Information on where to get this packet driver collection
  174.             from is provided as an appendix to this document.
  175.  
  176.             Actually Installing the Winsock.
  177.  
  178.             Before you  do  anything,  copy  the  files  winsock.dll,
  179.             tcpman.exe, winpkt.com, hosts, services and protocol to a
  180.             suitable directory.
  181.  
  182.               eg. c:\trumpet
  183.  
  184.             the essential files:
  185.                winsock.dll      the guts of the TCP/IP driver
  186.                tcpman.exe       interface program  for  managing  the
  187.                                 winsock
  188.                winpkt.com       virtual packet  driver  interface for
  189.                                 windows
  190.                hosts            list of host names & aliases
  191.                services         list of Internet services
  192.                protocol         list of Internet protocols
  193.  
  194.             Modify the path  line in  your autoexec.bat to  contain a
  195.             reference to that directory.
  196.  
  197.               eg. path c:\dos;c:\windows;c:\trumpet
  198.  
  199.             Make  sure  it  is  active  by   rebooting  or  executing
  200.             autoexec.bat again.
  201.  
  202.             The most basic  setup of  packet driver and  WINPKT would
  203.             look something like this example :
  204.  
  205.  
  206.                ne2000 0x60 2 0x300
  207.                WINPKT 0x60
  208.  
  209.  
  210.             The first line installs an NE2000 packet driver on vector
  211.             0x60 using IRQ 2 and I/O address 0x300
  212.  
  213.             The second line installs the WINPKT virtual packet driver
  214.             using the same vector  that the ne2000  packet driver was
  215.             installed on.
  216.  
  217.  
  218.  
  219.                                         5
  220.  
  221.  
  222.             This is  of course  an example  so your  mileage  will of
  223.             course vary.   Some example configurations  are described
  224.             later in this document.   Choose the one  which suits you
  225.             the best and modify it to your requirements.
  226.  
  227.             Now you are ready to start windows.  Start it up!!
  228.  
  229.             From windows, start up tcpman. From  the file manager, go
  230.             File/Run, and then "tcpman".  If this fails,  the path is
  231.             probably not set up  correctly, so fix it.  Later on, you
  232.             can install it as an icon to use it directly.
  233.  
  234.             Assuming you are a  first time user, a  setup screen will
  235.             appear giving you  a number of  options to fill  in.  You
  236.             will need  to fill  in a  few details  to enable  the TCP
  237.             package to function.   Fill in the  following details. If
  238.             you are unclear  on any  of them, try  to seek  some help
  239.             from qualified Internet support staff -  it will save you
  240.             a lot of time.
  241.  
  242.                IP address       your Internet IP address, "bootp", or
  243.                                 "rarp". lower  case please.    If you
  244.                                 use BOOTP,  be sure  to have  a BOOTP
  245.                                 service on the network or the winsock
  246.                                 will not load.
  247.                Netmask          your  Internet  network   mask.  (eg.
  248.                                 255.255.0.0)
  249.                Default Gateway  your default  Internet  gateway.  (IP
  250.                                 address)
  251.                Name server      your name server  IP address  for DNS
  252.                                 searches.  You may  provide more than
  253.                                 one   address   by   separating   the
  254.                                 addresses with spaces.  (IP addresses
  255.                                 only)
  256.                Time server      at present  unused  - future  winsock
  257.                                 API's may support this. (IP addresses
  258.                                 only)
  259.                Domain suffix    a  space  separated  list  of  domain
  260.                                 suffixes to  be  used when  resolving
  261.                                 names in the DNS system.
  262.                Packet Vector    either leave this as 00 to search for
  263.                                 the packet driver, or the vector that
  264.                                 you  installed   the   packet  driver
  265.                                 under.   The  number  is required  in
  266.                                 hexadecimal without the leading "0x".
  267.                                 In our  example,  you  would  provide
  268.                                 "60".  (numeric)
  269.  
  270.                MTU              Maximum Transmission  Unit. (numeric)
  271.                                 For Ethernet,  1500  is the  maximum,
  272.                                 and is recommended.
  273.                TCP RWIN         TCP  Receive  Window   (numeric)  eg.
  274.                                 (defaults to 4096 but can be larger)
  275.                TCP MSS          TCP Maximum  Segment  Size  (numeric)
  276.                                 (usually MTU - 40)
  277.  
  278.  
  279.  
  280.                                         6
  281.  
  282.  
  283.             The rest of the details should be greyed out and you need
  284.             not try  to fill  them in.  The Internal  SLIP  check box
  285.             should not be checked.
  286.  
  287.             The first  four  parameters  and  the  packet vector  are
  288.             required for successful functioning of the winsock, while
  289.             the rest can be tailored to suit your needs.
  290.  
  291.             When you are  done, click on  <OK> and if  all goes well,
  292.             the Trumpet  Winsock will  be initialised.   You  are now
  293.             ready to start using the winsock.
  294.  
  295.  
  296.             What to do if something goes wrong
  297.  
  298.             Firstly...
  299.  
  300.             The Trumpet Winsock  requires that your  have the correct
  301.             combination of  tcpman.exe,  winsock.dll and  winpkt.com.
  302.             When upgrading to  a new  release, replace each  of these
  303.             files to be sure that everything is up to date.
  304.  
  305.             If you get the messages about not finding a packet driver
  306.             or unable to load TCP, then  check that the packet driver
  307.             loaded properly, that WINPKT managed to find it, and that
  308.             the correct vector was chosen from tcpman.
  309.  
  310.             At the moment, only Ethernet and SLIP packet driver types
  311.             are supported.
  312.             Token ring  is  only available  via  the ibmtoken  packet
  313.             driver, and should work, but is untested by the author.
  314.  
  315.             ODI can be  used via  the ODIPKT shim,  and NDIS  via the
  316.             DIS_PKT shim.   examples  are provided  later on.   Also,
  317.             examples are provided of installation using NetWare.
  318.  
  319.             Possible causes for tcpman load errors specific to packet
  320.             drivers.
  321.  
  322.                unable to bind protocol 0806    another TCP  stack  is
  323.                                           using the  packet driver...
  324.                                           remove it.
  325.                WINPKT or pktdrv not found couldn't find  the  correct
  326.                                           packet driver.   Also check
  327.                                           the   vector    number   in
  328.                                           TCPMAN.
  329.                unable to allocate network buffers   critical error...
  330.                                           try to free up some special
  331.                                           driver memory  by  removing
  332.                                           windows device drivers.
  333.                network buffers low        not      critical       but
  334.                                           unadvisable... see above
  335.  
  336.             If WINPKT can't load (No packet driver found), check your
  337.             packet driver vector number.   Some drivers  may choose a
  338.             default vector which is not at  0x60. eg.  ODIPKT default
  339.             is 0x69
  340.  
  341.  
  342.  
  343.                                         7
  344.  
  345.  
  346.             If you are using  ODIPKT and you can't  get any response,
  347.             you probably accessing the  wrong protocol.   If you have
  348.             the ARP trace on,  you will possibly get  "ARP timed out"
  349.             messages as well.  The first  parameter of ODIPKT selects
  350.             the correct protocol. Try adjusting this.
  351.  
  352.             Anything else...   contact me.   I'll  try to  figure out
  353.             what's wrong, but first browse the samples provided.
  354.  
  355.  
  356.  
  357.                                         8
  358.  
  359.  
  360.  
  361.             Installing Trumpet Winsock over Internal SLIP
  362.  
  363.             SLIP is a  simple protocol  which allows an  Async serial
  364.             connection to send  Internet Protocol (IP).   You usually
  365.             need to  have access  to  a server  which  can understand
  366.             SLIP.  Usually,  SLIP is accessed  via a phone  line, and
  367.             with the advent of high speed modems, TCP/IP is a reality
  368.             over a dial-up connection.
  369.  
  370.             The Trumpet Winsock  has facilities  for managing  a SLIP
  371.             connection as well as the ability to use dialling scripts
  372.             for logging in and out of your SLIP server.
  373.  
  374.             Actually Installing the Winsock.
  375.  
  376.             Before you  do  anything,  copy  the  files  winsock.dll,
  377.             tcpman.exe, hosts,  services and  protocol to  a suitable
  378.             directory.
  379.  
  380.               eg. c:\trumpet
  381.  
  382.             the essential files:
  383.                winsock.dll      the guts of TCP/IP driver
  384.                tcpman.exe       interface program for  setting up the
  385.                                 winsock
  386.                hosts            list of host names
  387.                services         list of Internet services
  388.                protocol         list of Internet protocols
  389.  
  390.             Modify the path  line in  your autoexec.bat to  contain a
  391.             reference to that
  392.             directory.
  393.  
  394.               eg. path c:\dos;c:\windows;c:\trumpet
  395.  
  396.             Make  sure  it  is  active  by   rebooting  or  executing
  397.             autoexec.bat again.
  398.  
  399.             Now you are ready to start windows.  Start it up!!
  400.  
  401.             From windows, start up tcpman. From  the file manager, go
  402.             File/Run, and then "tcpman".  If this fails,  the path is
  403.             probably not set up  correctly, so fix it.  Later on, you
  404.             can install it as an icon to use it directly.
  405.  
  406.             Assuming you are a  first time user, a  setup screen will
  407.             appear giving you  a number of  options to fill  in.  You
  408.             will need  to fill  in a  few details  to enable  the TCP
  409.             package to function.   Fill in the  following details. If
  410.             you are unclear  on any  of them, try  to seek  some help
  411.             from qualified Internet support staff -  it will save you
  412.             a lot of time.
  413.  
  414.             Firstly, click on Internal SLIP.   Some of the parameters
  415.             will be greyed and others ungreyed.
  416.  
  417.  
  418.  
  419.                                         9
  420.  
  421.  
  422.                IP address       your Internet IP  address or "bootp".
  423.                                 lower case  only. Only  use  BOOTP if
  424.                                 you are not  intending to use  a dial
  425.                                 in script.  If using a dialler script
  426.                                 with the  address  extracted  by  the
  427.                                 script, or BOOTP later, just leave it
  428.                                 with default value  of 0.0.0.0   Only
  429.                                 use BOOTP if your server supports it,
  430.                                 otherwise the winsock  will delay for
  431.                                 about  15  seconds  and  the  message
  432.                                 "Unable to load TCP" will come up.
  433.                Name server      your name server  IP address  for DNS
  434.                                 searches.  You may  provide more than
  435.                                 one   address   by   separating   the
  436.                                 addresses with spaces.  (IP addresses
  437.                                 only).
  438.                Time server      at present  unused  - future  winsock
  439.                                 API's may support this. (IP addresses
  440.                                 only).
  441.                Domain suffix    a  space  separated  list  of  domain
  442.                                 suffixes to  be  used when  resolving
  443.                                 names in the DNS system.
  444.                MTU              Maximum Transmission Unit. Related to
  445.                                 TCP MSS...  usually  TCP  MSS  +  40.
  446.                                 (Numeric)
  447.                TCP RWIN         TCP Receive Window. It is recommended
  448.                                 that this  value  be roughly  3  to 4
  449.                                 times the value of TCP MSS. (Numeric)
  450.                TCP MSS          TCP  Maximum  Segment   Size,  It  is
  451.                                 recommended that  this be  a smallish
  452.                                 value when using SLIP - say 512 bytes
  453.                                 for SLIP and  lower for  CSLIP. CSLIP
  454.                                 is  able   to   compress  data   more
  455.                                 efficiently when it is less than 255.
  456.                                 (numeric)
  457.                SLIP port        your  comms  port   number  ..1=com1,
  458.                                 2=com2 etc. (numeric)
  459.                baud rate        the  speed  you   wish  to   run  at.
  460.                                 (numeric)
  461.                hardware handshake    recommended   if    your    link
  462.                                 supports it.
  463.                Van Jacobson CSLIP
  464.                Compression      if your server  will support  it. You
  465.                                 may also  have to  adjust MTU,  MSS &
  466.                                 RWIN. to be suitable.
  467.                Online Status
  468.                Detection        if your modem will support it, select
  469.                                 DCD or DSR on-line status detection.
  470.  
  471.  
  472.             The rest of the details should be greyed out and you need
  473.             not try to fill them in.
  474.  
  475.             When you are  done, click on  <OK> and if  all goes well,
  476.             the Trumpet  Winsock will  be initialised.   You  are now
  477.             ready to start using the winsock.
  478.  
  479.             Logging in to the server.
  480.  
  481.  
  482.  
  483.                                         10
  484.  
  485.  
  486.  
  487.             You can  use either  the  manual login  or  the automatic
  488.             scripting to  access your  server.   For the  time being,
  489.             choose  manual  and   log  into  your   server  with  the
  490.             appropriate commands.  Don't forget to  use the <esc> key
  491.             to get out  when you  have finished  dialling in.   After
  492.             logging in, you may need to go and set your IP address if
  493.             it is allocated dynamically.
  494.  
  495.             If you wish to use another terminal program to dial in to
  496.             the server, don't forget  to issue AT&D0,  or disable DTR
  497.             dropping when exiting the program, or the connection will
  498.             be severed when the application closes the comms port.
  499.  
  500.             Try out pingw to a well  known host IP address  to see if
  501.             all is well.
  502.  
  503.             Problems
  504.  
  505.             Check your baud rates...
  506.             If using hardware  hand shaking  with an  external modem,
  507.             make sure the cable is correctly wired.
  508.             At the moment, all  dialling must be done  with 8bits, no
  509.             parity.  This may not work for you...  you will then need
  510.             to use an external dialler.   The next revision will have
  511.             an extension to the dialler to allow this.
  512.  
  513.             If all else fails... contact me !!
  514.  
  515.             Once you have determined your login sequence, you can set
  516.             up a login  script.   A sample  script is  provided along
  517.             with a listing of a typical session.
  518.  
  519.             Automatic dialling.
  520.  
  521.             Minimal scripting is  supported, and the  script commands
  522.             are
  523.  
  524.                input <timeout> <string>   wait for string received.
  525.                output <string>            send string.
  526.                display <string>           display string on display.
  527.                wait <timeout> { DSR | CTS | RLSD | DCD}
  528.                                           wait  for  DSR  or  CTS  or
  529.                                           RLSD(DCD)
  530.                trace ( on | off )         useful    for     debugging
  531.                                           scripts
  532.                echo (on | off)            defaults to on
  533.                password <prompt>          message box for password
  534.                username <prompt>          message box for username
  535.                address <timeout>          parse IP address
  536.                set (DTR | RTS) (on | off) set/reset the modem lines.
  537.                sleep <seconds>            pause for so many seconds.
  538.                exec <string>              program will be  started up
  539.                                           concurrently          using
  540.                                           winexec().
  541.                online                     enter SLIP mode.   commands
  542.                                           depending    on    received
  543.                                           characters  will  not  work
  544.  
  545.  
  546.  
  547.                                         11
  548.  
  549.  
  550.                                           correctly    after     this
  551.                                           command is issued since the
  552.                                           winsock will interpret data
  553.                                           as  SLIP  frames.    Useful
  554.                                           before  an   exec   command
  555.                                           which uses the winsock.
  556.                BOOTP                      inform the  winsock  that a
  557.                                           BOOTP  will   be   required
  558.                                           after   the    script   has
  559.                                           finished.
  560.  
  561.                # means start comment except inside string
  562.  
  563.             string arguments
  564.             \l   line feed
  565.             \r   return
  566.             \n   cr/lf pair
  567.             \f   form feed
  568.             \t   tab
  569.             \b   backspace
  570.             \nnn ASCII value in decimal
  571.             \i   IP address
  572.             \p   password
  573.             \u   username
  574.             \c   comm port number  (as you have configured it)
  575.  
  576.             a sample script is  given for logging in  to our Xylogics
  577.             terminal server.
  578.  
  579.                  output atz\13
  580.                  input 10 OK\n
  581.                  #output atd242284\13
  582.                  output atd241644\13
  583.                  input 30 CONNECT
  584.                  input 30 \n
  585.                  wait 30 dsr
  586.                  output \13
  587.                  input 30 username:
  588.                  output tattam\13
  589.                  input 30 password:
  590.                  password Enter your password
  591.                  output \p\13
  592.                  input 30 >
  593.                  output who\13
  594.                  input 30 >
  595.                  output slip\13
  596.                  input 30 Your address is
  597.                  address 30
  598.                  input 30 \n
  599.                  display \n
  600.                  display Connected.  Your IP address is \i.\n
  601.                  exec pingw 131.217.10.1
  602.  
  603.  
  604.             Here's a  log  of a  typical  session.   Names  have been
  605.             blanked out for security.
  606.  
  607.                  Trumpet Winsock Version 1.00 Alpha #18
  608.  
  609.  
  610.  
  611.                                         12
  612.  
  613.  
  614.                  Copyright (c) 1993 by Peter R. Tattam
  615.                  All Rights Reserved.
  616.                  SLIP ENABLED
  617.                  Internal SLIP driver COM3 Baud rate = 38400 Hardware
  618.                  handshaking
  619.                  My ip = 131.217.8.4 netmask = 255.255.0.0 gateway =
  620.                  131.217.250.1
  621.                  Executing script c:\dev\tcpip\winsock\login.cmd
  622.                  SLIP DISABLED
  623.                  atz
  624.                  OK
  625.                  atd241644
  626.                  CONNECT 38400
  627.  
  628.  
  629.                  Annex Command Line Interpreter   *   Copyright 1991
  630.                  Xylogics, Inc.
  631.  
  632.                  Checking authorization, Please wait...
  633.                  Annex username: xxxxxx
  634.                  Annex password:
  635.  
  636.                  Permission granted
  637.                  University of Tasmania
  638.                  AARNet Terminal Server
  639.  
  640.                  SLIP users:
  641.                  Use a maximum segment size (MSS) of 209
  642.                  and a maximum transmission unit (MTU) of 255.
  643.  
  644.                  Async AppleTalk users:
  645.                  Configure MacTCP to use the Computing Centre zone.
  646.                          *** Note change in procedures for starting
  647.                  async AppleTalk.
  648.                          *** After typing atalk you will be prompted
  649.                  for your password
  650.                          *** again.
  651.                  AARNET TS5 >who
  652.                  Port What User             Location          When
  653.                  Idle  Address
  654.                   2   CLI  xxxxxxxx         ---               8:01pm
  655.                  [local]
  656.                        +1    'telnet tasman.cc'
  657.                   3   CLI  xxxxxxxx         ---               8:15pm
  658.                  [local]
  659.                        +1    'rlogin franklin.cc'
  660.                   4   SLIP modem4           ---               8:19pm
  661.                  ants
  662.                   5   CLI  xxxxxxxx         ---               8:34pm
  663.                  [local]
  664.                   6   CLI  xxxxxxxx         ---               7:19pm
  665.                  [local]
  666.                        +1    'rlogin baudin.cc'
  667.                   17  SLIP modem18          ---               6:39pm
  668.                  ants
  669.                  AARNET TS5 >slip
  670.  
  671.                  Switching to SLIP.
  672.  
  673.  
  674.  
  675.                                         13
  676.  
  677.  
  678.                  Annex address is 131.217.250.10.  Your address is
  679.                  131.217.8.5.
  680.  
  681.                  Connected.  Your IP address is 131.217.8.5.
  682.  
  683.                  Script completed
  684.                  SLIP ENABLED
  685.  
  686.             Dialler problems.
  687.  
  688.             Q. tcpman just  pauses when  starting up, then  gives the
  689.             message "unable to load TCP".
  690.  
  691.             A. You've probably got BOOTP set.   Replace it by 0.0.0.0
  692.             before dialling and try again. RARP is impossible to send
  693.             via SLIP so don't bother with that.
  694.  
  695.             Q. The  connection appears  to  be too  slow  compared to
  696.             Xmodem.
  697.  
  698.             A.  Possibly the  MTU/MSS & RWIN settings  are not right.
  699.             Try to make  RWIN about  3 to  4 times  MSS and  an exact
  700.             multiple if possible.   Turn  on the IP  trace to  see if
  701.             fragmentation is occurring  on TCP  connections.   If so,
  702.             then reduce MSS until  it stops.  UDP  packets will still
  703.             be fragmented, but  nothing can be  done about that.   On
  704.             the trace, TCP is type 6 while UDP is type 17.
  705.  
  706.             Q.  Some input commands in the script don't work.
  707.  
  708.             A. Check for upper case/lower case conflicts.  Also check
  709.             for blanks at the end of the lines.
  710.  
  711.  
  712.             For other problems, contact me at
  713.  
  714.             trumpet-bugs@petros.psychol.utas.edu.au, or  subscribe to
  715.             the Trumpet  discussion  group  and  ask  your  question.
  716.             Details are at  the end of  this document.   As time goes
  717.             on, various FAQ's  will be  constructed to cope  with the
  718.             more common problems.
  719.  
  720.  
  721.  
  722.                                         14
  723.  
  724.  
  725.             Sample Configurations for Packet Driver.
  726.  
  727.             1. Plain ne2000 packet driver using WINPKT.
  728.  
  729.                  ne2000 0x60 2 0x300
  730.                  WINPKT 0x60
  731.  
  732.             2. Ne2000 packet driver with Novell  NetWare access using
  733.             WINPKT.
  734.             Important is the  specification of  the -n switch  of the
  735.             packet driver.   Some packet  drivers don't  support this
  736.             switch.   In that  case, you  may  be forced  to  use ODI
  737.             instead. An example could be the Xircom Pocket Adapter.
  738.  
  739.                  ne2000 -n 0x60 2 0x300
  740.                  WINPKT 0x60
  741.                  pdipx
  742.                  netx
  743.                  path c:\dos;c:\network\win31
  744.                  f:
  745.                  login
  746.  
  747.  
  748.             3. Ne2000 packet driver with Novell  NetWare access using
  749.             PKTMUX.  Notice that WINPKT is  not required since PKTMUX
  750.             does a similar job.
  751.  
  752.                  ne2000 -n 0x60 2 0x300
  753.                  pktmux 4
  754.                  pktdrv
  755.                  pktdrv
  756.                  pktdrv
  757.                  pktdrv
  758.                  pdipx
  759.                  netx
  760.                  path c:\dos;c:\network\win31
  761.                  f:
  762.                  login
  763.  
  764.             4. ODI setup with NetWare access.
  765.  
  766.             You will need ODIPKT.  The latest known release is 2.4 It
  767.             is important that  ODIPKT reference the  correct protocol
  768.             for IP  access.  This  can  be  specified  as  the  first
  769.             parameter to ODIPKT (0=1st, 1=2nd and so forth)
  770.  
  771.             Here's a sample of my network attach batch file.
  772.  
  773.                  @echo off
  774.                  cd \
  775.                  lh lsl
  776.                  lh \odi\ne2000
  777.                  cd \net
  778.                  lh ipxodi
  779.                  lh odipkt
  780.                  lh WINPKT 0x69
  781.                  lh netx
  782.                  path c:\dos;c:\net\win31
  783.  
  784.  
  785.  
  786.                                         15
  787.  
  788.  
  789.                  f:
  790.                  echo on
  791.                  login
  792.  
  793.             Also, your net.cfg must be suitably configured.  Here are
  794.             the relevant excerpts from my net.cfg
  795.  
  796.                  Link Support
  797.                           Buffers 8 1586
  798.                           MemPool 16384
  799.  
  800.                  Link Driver NE2000
  801.                           Port #1 300 20
  802.                           Int #1 2
  803.                           Frame Ethernet_II
  804.                           Frame Ethernet_802.3
  805.                           Protocol IPX 0 Ethernet_802.3
  806.  
  807.  
  808.             The ordering of the frame protocols  is important for the
  809.             default setup  of ODIPKT.   Also,  users should  be aware
  810.             that there  are two  versions of  ODIPKT, one  released I
  811.             believe by FTP  Software, and the  public domain one.   I
  812.             refer to the public domain version.  Also note that there
  813.             are two programs with the same name of "ne2000.com".  One
  814.             is a  packet  driver and  is  referred to  in  an earlier
  815.             section.  The one referred to in this section is actually
  816.             an ODI driver  and won't function  as a packet  driver at
  817.             all.
  818.  
  819.             5. NDIS  &  Windows for  Workgroups  setup. (courtesy  of
  820.             Peter Whisker, WhiskerP@LGWCT.LOGICA.COM)
  821.  
  822.             Installation  of  Trumpet   Winsock  makes  use   of  the
  823.             DIS_PKT9.DOS or DIS_PKT.DOS shims which  provide a Packet
  824.             Driver interface the NDIS.  The  version I have tested is
  825.             found on a number of sites  as DISPKT11.ZIP, and contains
  826.             DIS_PKT.DOS dated 28/4/93.  The example is  based upon an
  827.             actual configuration  using  DEC  Pathworks  version  4.1
  828.             (DECNET version)  with  a  DEPCA  Ethernet  card.    This
  829.             installation assumes that  you have  NDIS up  and running
  830.             and have a valid PROTOCOL.INI file.
  831.  
  832.             You need to perform three basic steps:
  833.                Load the  DIS_PKT driver  in CONFIG.SYS  following  the
  834.                load of PROTMAN.SYS:
  835.  
  836.                  DEVICEHIGH=\DECNET\PROTMAN.SYS /I:C:\DECNET
  837.                  DEVICEHIGH=\DECNET\DEPCA.DOS
  838.                  DEVICEHIGH=\DECNET\DIS_PKT.DOS
  839.  
  840.                Add  a  few  lines   to  PROTOCOL.INI  (here   labelled
  841.                [PKTDRV]) in order to bind  it to the Ethernet  driver.
  842.                In this example, DIS_PKT.DOS  is configured with packet
  843.                vector 60.
  844.  
  845.                  [DEPCA.DOS]
  846.                  DRIVERNAME = DEPCA$
  847.  
  848.  
  849.  
  850.                                         16
  851.  
  852.  
  853.                  .
  854.                  .
  855.                  .
  856.                  [PKTDRV]
  857.                    DRIVERNAME = PKTDRV
  858.                    BINDINGS = DEPCA.DOS
  859.                    INTVEC = 0x60
  860.  
  861.                In AUTOEXEC.BAT, load WINPKT or PKTMUX as  described in
  862.                examples 2 and 3 above.  This should be done  after the
  863.                NETBIND command in your NDIS startup has been executed.
  864.                In the  case of  Pathworks,  this command  is  normally
  865.                contained in STARTNET.BAT. For example:
  866.  
  867.                  call \decnet\startnet.bat
  868.                  WINPKT 0x60
  869.  
  870.  
  871.             6.   Some more  packet driver  installations  courtesy of
  872.             Ashok Aiyar (ashok@biochemistry.bioc.crwu.edu)
  873.  
  874.             Configuration for  Cabletron Network  Cards.   The packet
  875.             driver provided by Cabletron is a  little confusing as it
  876.             doesn't use  the same  parameters as  packet-drivers that
  877.             use the Crynwr skeleton.
  878.  
  879.             Typically the Cabletron driver is loaded as:
  880.  
  881.             "csipd_e /s:62 /h:7 /p:300"
  882.  
  883.             In this  example the  software interrupt  is 0x62.   Load
  884.             winpkt.com as
  885.  
  886.             "WINPKT 0x62"
  887.  
  888.             Release 11 of the Crynwr packet drivers includes a driver
  889.             for Cabletron  cards  written by  Kai  Getrost using  the
  890.             Crynwr skeleton  that  uses the  same  parameters as  the
  891.             other Crynwr drivers.   This driver  (CTRONDNI.COM) seems
  892.             to work well  with E1020/1040 and  E2020 Cabletron cards.
  893.             Indeed I  see  a  performance  gain  over  the  Cabletron
  894.             driver.  Your mileage may vary.
  895.  
  896.             C/SLIPPER with PKTMUX.  Although the  Trumpet Winsock has
  897.             built in support for C/SLIP, there are situations when in
  898.             addition to Winsock applications  there is a  need to run
  899.             packet driver  applications  simultaneously  over a  SLIP
  900.             link.  For such situations, PKTMUX is of utility.
  901.  
  902.             Example:
  903.  
  904.             CSLIPPER vec=65 com1 irq=04H baud=57600 ether
  905.             PKTMUX 4 65 /4  .... (support for  a maximum of 4 virtual
  906.             packet drivers)
  907.             PKTDRV 60 65
  908.  
  909.             Configure the Trumpet  Winsock to use  the virtual packet
  910.             driver  at  0x60.    All  other  virtual  packet  drivers
  911.  
  912.  
  913.  
  914.                                         17
  915.  
  916.  
  917.             (PKTDRV) can be loaded  in the DOS Windows  in which they
  918.             are used.    They  need  not  be loaded  before  entering
  919.             Windows.
  920.  
  921.             (Ed. Note... You  may also require  the use of  a special
  922.             comms buffer  to  enhance the  buffering  capabilities of
  923.             Windows when  using slipper/cslipper.   An  FAQ  on doing
  924.             this is  available  from  biochemistry.bioc.cwru.edu  via
  925.             gopher or FTP.  It is not  needed when using the internal
  926.             SLIP functions of the Winsock)
  927.  
  928.             Extra Info
  929.  
  930.             You may use environment variables or command line options
  931.             to override some  of the  network parameters.   They have
  932.             the same names  as the  saved parameters  in trmpwsk.ini.
  933.             This file  normally  resides  in  the  winsock  directory
  934.             rather than the windows directory  since this facilitates
  935.             setting up the  winsock in  a networked environment.   IP
  936.             addresses can  be  overridden  by  using the  environment
  937.             variables, or the command line.
  938.  
  939.             example of command line.
  940.  
  941.                tcpman -ip=123.231.213.123 -netmask=255.255.255.0
  942.  
  943.             example of environment variable
  944.  
  945.               set ip=123.231.213.123
  946.               set netmask=255.255.255.0
  947.  
  948.             Here's a list of parameters.
  949.  
  950.                ip/myip          your IP address or  'bootp' or 'rarp'
  951.                                 (lower case only)
  952.                netmask          your netmask.  eg.  255.255.0.0
  953.                gateway/mygatewayyour gateway (IP address)
  954.                dns              list of DNS IP addresses
  955.                time             list of time server IP addresses
  956.                domain           list of domain name suffixes
  957.                vector           packet driver vector in hex
  958.                MTU              Maximum Transmission Unit
  959.                RWIN             TCP Receive Window.
  960.                MSS              TCP Maximum Segment Size
  961.                slip-enabled     0 = off, 1 = on
  962.                slip-port        port number (1-9)
  963.                slip-baudrate    baud rate in decimal
  964.                slip-handshake   0 = off, 1 = on
  965.                slip-compressed  0 = off, 1 = on
  966.  
  967.             The Crynwr packet driver collection
  968.  
  969.             Availability
  970.  
  971.             The Crynwr packet driver collection is available by mail,
  972.             by FTP, by e-mail, by UUCP and by modem.  The drivers are
  973.             distributed in three files: drivers.zip, which contains
  974.             executables and documentation, drivers1.zip, which
  975.  
  976.  
  977.  
  978.                                         18
  979.  
  980.  
  981.             contains the first half of the .ASM files, and
  982.             drivers2.zip, which contains the second half of the .ASM
  983.             files.
  984.  
  985.             Mail:
  986.  
  987.             Columbia University distributes packet drivers by mail.
  988.             The formats are 9-track 1600 bpi tapes in ANSI, tar, or
  989.             OS SL format, or PC diskettes (360K 5.25" and 720K 3.5").
  990.             The exact terms and conditions have yet to be worked out,
  991.             please call (212) 854-3703 for ordering information, or
  992.             write to:
  993.  
  994.               Kermit Distribution, Dept PD
  995.               Columbia University Center for Computing Activities
  996.               612 West 115th Street
  997.               New York, NY  10025
  998.  
  999.             or send e-mail to kermit@watsun.cc.columbia.edu
  1000.             (Internet) or
  1001.             KERMIT@CUVMA (BITNET/EARN).
  1002.  
  1003.  
  1004.             FTP/e-mail:
  1005.  
  1006.             The packet driver collection has its own directory
  1007.             devoted to it, pd1:<msdos.pktdrvr>.  The drivers are
  1008.             there, along with many free programs that use the packet
  1009.             drivers.
  1010.  
  1011.             SIMTEL20 files are also available from mirror sites
  1012.             OAK.Oakland.Edu
  1013.             (141.210.10.117), wuarchive.wustl.edu (128.252.135.4),
  1014.             ftp.uu.net (192.48.96.9), nic.funet.fi (128.214.6.100),
  1015.             src.doc.ic.ac.uk (146.169.3.7) or rana.cc.deakin.oz.au
  1016.             (128.184.1.4), or by e-mail through the BITNET/EARN file
  1017.             servers.
  1018.  
  1019.             Modem:
  1020.  
  1021.             If you cannot access them via FTP or e-mail, most
  1022.             SIMTEL20 MSDOS files, including the PC-Blue collection,
  1023.             are also available for downloading from Detroit Download
  1024.             Central (313) 885-3956.  DDC has multiple lines which
  1025.             support 300/1200/2400/9600/14400 bps
  1026.             (103/212/V22bis/HST/V32bis/V42bis/MNP).  This is a
  1027.             subscription system with an average hourly cost of 17
  1028.             cents.  It is also accessable on Telenet via PC Pursuit
  1029.             and on Tymnet via StarLink outdial.  New files uploaded
  1030.             to SIMTEL20 are usually available on DDC within 24 hours.
  1031.  
  1032.             CD-ROM:
  1033.  
  1034.             Public, private or corporate institutions and libraries
  1035.             interested in the SIMTEL20 MSDOS collection in CD-ROM
  1036.             format bundled with library card-catalog type access and
  1037.             duplication software can contact Coyote Data, Ltd. by
  1038.  
  1039.  
  1040.  
  1041.                                         19
  1042.  
  1043.  
  1044.             mail at 1142 N. Main, Rochester, MI 48307 or by FAX at
  1045.             (313) 651-4071.
  1046.  
  1047.             UUCP:
  1048.  
  1049.             The packet driver files are available from UUNET's 1-900-
  1050.             GOT-SRCS, in uunet!~/systems/msdos/simtel20/pktdrvr.  See
  1051.             UUNET.DOC for details.
  1052.  
  1053.             ODIPKT location
  1054.  
  1055.             I am told  that the  originating site  for ODIPKT  is the
  1056.             following...
  1057.  
  1058.             Host hsdndev.harvard.edu
  1059.  
  1060.                  Location: /pub/odipkt
  1061.                         FILE -rwxr-xr-x           2915  Aug  21 20:01
  1062.             odipkt.com
  1063.  
  1064.             A copy of the NDIS shim is there also.
  1065.  
  1066.  
  1067.  
  1068.                                         20
  1069.  
  1070.  
  1071.  
  1072.             Trumpet General Discussion Group.
  1073.  
  1074.             The machine petros.psychol.utas.edu.au  is now  running a
  1075.             local news service with the news groups
  1076.  
  1077.                  trumpet.announce
  1078.                  trumpet.bugs
  1079.                  trumpet.feedback
  1080.             &    trumpet.questions
  1081.  
  1082.             If you do not have access directly to this service, these
  1083.             news groups are gatewayed to the following mailing list.
  1084.  
  1085.             You may join  the new Trumpet  mailing list by  sending a
  1086.             message to
  1087.  
  1088.                  listproc@petros.psychol.utas.edu.au
  1089.  
  1090.             with just one line in the body.
  1091.  
  1092.                  subscribe trumpet-user Your Full Name
  1093.  
  1094.             Where "Your Full Name" should be  replaced by your actual
  1095.             full name.
  1096.  
  1097.             The list is called
  1098.  
  1099.                  trumpet-user@petros.psychol.utas.edu.au
  1100.  
  1101.  
  1102.             and is running on a 486/50 FreeBSD system.  Hopefully it
  1103.             will cope ;-)
  1104.  
  1105.             You can  ask  questions, or  discuss  any  aspect of  any
  1106.             Trumpet program  on  this  group.    Feedback  is  always
  1107.             welcome.  There  is also an  anonymous FTP area  with all
  1108.             the latest Trumpet programs and pre-releases.   If you do
  1109.             use a  pre-release, be  prepared for  unexpected problems
  1110.             since such programs are in alpha/beta test.
  1111.  
  1112.  
  1113.             Bugs or Comments
  1114.  
  1115.             Send to
  1116.  
  1117.                trumpet-bugs@petros.psychol.utas.edu.au
  1118.  
  1119.             For bug  reports,  please  send  a  copy  of  config.sys,
  1120.             autoexec.bat,  trumpwsk.ini,   and  any   other  relevant
  1121.             network configurations.   In the  case of ODI,  also send
  1122.             net.cfg.  We  will do my  best to sort  out your problem.
  1123.             Due to the high  demand for the Trumpet  Winsock, my mail
  1124.             box can be overloaded  at times.  Be  patient...  someone
  1125.             will answer you.
  1126.  
  1127.  
  1128.  
  1129.                                         21
  1130.  
  1131.  
  1132.             TCPMAN - The Trumpet Winsock TCP Manager
  1133.  
  1134.             Menu options.
  1135.  
  1136.             File/Setup          calls  up   the   setup  dialog   for
  1137.             configuration
  1138.  
  1139.                  IP address          your  IP  address,   "bootp"  or
  1140.                                      "rarp" (lower case).
  1141.                                      BOOTP will only work if there is
  1142.                                      a BOOTP service on-line.
  1143.                                      RARP will  only  work  if  using
  1144.                                      Ethernet, and  there is  an RARP
  1145.                                      service on-line.
  1146.                  Netmask             your network mask.
  1147.                  Default gateway     your default Internet gateway or
  1148.                                      router.
  1149.                  Name server         your Domain Name Server address.
  1150.                  Time server         (unused leave empty)
  1151.                  Domain Suffix       A  space   separated   list   of
  1152.                                      suffixes  to   be   tried   when
  1153.                                      looking up  names  via the  name
  1154.                                      server.
  1155.                  Packet Vector       for accessing the  packet driver
  1156.                                      in hex.
  1157.                  MTU                 Maximum Transmission Unit.
  1158.                  TCP RWIN            TCP Receive Window
  1159.                  TCP MSS             TCP Maximum Segment Size
  1160.  
  1161.                  Demand Load Timeout Number of  seconds  tcpman stays
  1162.                                      loaded after the application has
  1163.                                      finished with it.
  1164.  
  1165.                  Internal SLIP       Click on this  for internal SLIP
  1166.                                      support & dialler support.
  1167.                  SLIP port           which comms port to use.
  1168.                  Baud Rate           speed of the connection.
  1169.                  Hardware Handshaking     turn   on    for    RTS/CTS
  1170.                                      handshaking.  May   require  the
  1171.                                      AT&K3 modem command  to function
  1172.                                      properly.
  1173.                  Van Jacobson CSLIP compression
  1174.                                      turn on  for  CSLIP  TCP  header
  1175.                                      compression.
  1176.  
  1177.                  Online Status Detection  needed     for      dialler
  1178.                                      autologin / autologout enabling.
  1179.                     None             no online status detection
  1180.  
  1181.                     DCD (RLSD) check may require AT&C1  modem command
  1182.                                      to function.
  1183.  
  1184.                     DSR check        may require AT&S1  modem command
  1185.                                      to function.
  1186.  
  1187.  
  1188.  
  1189.                                         22
  1190.  
  1191.  
  1192.             File/Register       calls up the registration dialog.
  1193.             File/Exit           quits the  TCP  manager, forcing  the
  1194.             winsock to be unloaded.
  1195.  
  1196.             Edit/Copy           copy selected text  on tcpman display
  1197.             to the clipboard
  1198.             Edit/Clear          clear the tcpman display
  1199.  
  1200.             Tracing options.   Use with care  since some applications
  1201.             may crash when the  traces are active.   Should a program
  1202.             crash with stack overflow, the winsock  may remain loaded
  1203.             in memory even though tcpman has exited.  It is advisable
  1204.             to restart windows if  this happens and  possibly even to
  1205.             reboot your machine.   Also,  timing measurements  of the
  1206.             winsock throughput will be severely affected by the trace
  1207.             options.
  1208.  
  1209.             Trace/TCP           turn TCP trace on/off
  1210.             Trace/UDP           turn UDP trace on/off
  1211.             Trace/IP            turn IP tracing on/off
  1212.             Trace/ARP           turn ARP tracing on/off
  1213.             Trace/RARP          turn RARP tracing on/off
  1214.             Trace/Ethernet      add Ethernet  headers  to IP/ARP/RARP
  1215.             traces.
  1216.             Trace/Extra detail  add some extra  detail to TCP,  UDP &
  1217.             IP traces.
  1218.             Trace/Socket calls  trace each winsock call.
  1219.                                 most  parameters  are   displayed  as
  1220.             well.
  1221.             Trace/DNS           trace Domain Name Server operations.
  1222.                                 Use with care, stack overflows can be
  1223.             frequent.
  1224.             Trace/Messages      trace Async Socket messages.
  1225.  
  1226.  
  1227.  
  1228.                                         23
  1229.  
  1230.  
  1231.  
  1232.             Dialler/Login       invoke the login.cmd dialler script.
  1233.             Dialler/Bye         invoke the bye.cmd dialler script.
  1234.             Dialler/Other       invoke other scripts.
  1235.                                 a file selection dialog of *.cmd will
  1236.             be
  1237.                                 displayed.
  1238.             Dialler/Options     call up the dialler options dialog.
  1239.  
  1240.                  No automatic login
  1241.                  Automatic login on startup only.
  1242.                  Automatic login and logout on demand.
  1243.  
  1244.                  SLIP inactivity timeout (minutes)  Number of minutes
  1245.                                           to  wait   before   exiting
  1246.                                           winsock.      (when      no
  1247.                                           application  is  using  the
  1248.                                           winsock.)   Automatic login
  1249.                                           & logout  must  be  enabled
  1250.                                           for this to  close the SLIP
  1251.                                           connection.   A value  of 0
  1252.                                           disables the timeout.
  1253.  
  1254.             Dialler/Manual Login     invoke the dialler manually.
  1255.                                 Use <esc>  to  exit  from the  manual
  1256.             dialler.
  1257.             Dialler/Edit Scripts     invokes  notepad  to   edit  any
  1258.             script.
  1259.  
  1260.             Help/About          Display  the   version   number   and
  1261.             copyright.
  1262.  
  1263.  
  1264.  
  1265.                                         24
  1266.  
  1267.  
  1268.             Registration
  1269.  
  1270.  
  1271.             Registration of the  Trumpet Winsock is  encouraged since
  1272.             it funds further development of the winsock.  It involves
  1273.             sending in  a  registration  form  filled  in  with  your
  1274.             registration name and other details.   On receipt of your
  1275.             registration, you  will  receive  a  password which  will
  1276.             remove the  UNREGISTERED  VERSION notice  and  replace it
  1277.             with  your   registration  name.     As   part   of  this
  1278.             registration, you will receive enough support  to get you
  1279.             going within the existing capabilities of  the winsock at
  1280.             the  present  time,  and  preference  will  be  given  to
  1281.             registered users  when it  comes to  bug fixes  or future
  1282.             enhancements  to  the  winsock.    Packet  drivers  using
  1283.             Ethernet  and  SLIP  are  presently  the  only  supported
  1284.             network access.   The winsock  will function  through the
  1285.             use of packet driver shims for  ODI, NDIS and token ring,
  1286.             but the use  of these  is not  supported, neither  is the
  1287.             winsock supported should you be using PKTMUX.
  1288.  
  1289.  
  1290.             The  Trumpet   Winsock   is   currently  distributed   as
  1291.             shareware. You may use the Trumpet Winsock for 30 days to
  1292.             evaluate its usefulness.  If at the  end of that time you
  1293.             are satisfied with the Trumpet Winsock  as a product, you
  1294.             can register it.  The basic registration fee for a single
  1295.             user version  of the  Trumpet Winsock  is US$20.    See a
  1296.             later section for details on multi-user site licenses.
  1297.  
  1298.             Australian users should  contact me  regarding Australian
  1299.             pricing information and availability.
  1300.  
  1301.             Cheques or Postal Orders should be made out to
  1302.  
  1303.                  Trumpet Software International
  1304.  
  1305.             and sent to
  1306.  
  1307.                  Trumpet Software International
  1308.                  GPO Box 1649,
  1309.                  HOBART, TAS AUSTRALIA 7001
  1310.  
  1311.             You should fill out the following  order form and send it
  1312.             along with  your  cheque or  Postal  Order  to the  above
  1313.             address.
  1314.  
  1315.             FAX/Phone International  61-02-487049,    Australia  002-
  1316.             487049
  1317.  
  1318.             Please note that  International mail can  be rather slow,
  1319.             and  it  may  take  up  to   2  months  to  receive  your
  1320.             registration.
  1321.  
  1322.  
  1323.  
  1324.                                         25
  1325.  
  1326.  
  1327.  
  1328.                +----------------------------------------------+
  1329.                |              O R D E R   F O R M             |
  1330.                | for Trumpet Winsock version 1.0 Software     |
  1331.                +----------------------------------------------+
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.             Ship to:                            Bill to:
  1339.  
  1340.             [                                            ]          [
  1341.             ]
  1342.             [                                            ]          [
  1343.             ]
  1344.             [                                            ]          [
  1345.             ]
  1346.             [                                            ]          [
  1347.             ]
  1348.             [                                            ]          [
  1349.             ]
  1350.  
  1351.  
  1352.             Please supply the following items:
  1353.  
  1354.             ---------------------------------------------------------
  1355.             -------------
  1356.  
  1357.             Licence to use Trumpet Winsock 1.0 for [       ] users
  1358.                                                              . .  . .
  1359.             . US$[       ]
  1360.  
  1361.             Tick at least one of the following options.
  1362.             [ ] 5.25" disk with the latest version of Trumpet Winsock
  1363.             + password
  1364.             [ ] 3.5"  disk with the latest version of Trumpet Winsock
  1365.             + password
  1366.             [ ] registration password via post
  1367.             [ ] registration password via e-mail
  1368.  
  1369.             Your  registration  name   (required)  (will   appear  on
  1370.             program)
  1371.  
  1372.             [________________________________________________________
  1373.             ____________]
  1374.  
  1375.             Your e-mail address (optional - print clearly)
  1376.             [________________________________________________________
  1377.             ____________]
  1378.  
  1379.  
  1380.             Date sent  [______________]       Expected delivery  Date
  1381.             [_______________]
  1382.  
  1383.  
  1384.  
  1385.                                         26
  1386.  
  1387.  
  1388.             Site Licenses
  1389.  
  1390.             A  site  license  is  defined  as  being  a  sale  to  an
  1391.             organisation  or  company,  and  may  not  be  resold  or
  1392.             redistributed for profit. It may only be used within that
  1393.             organisation.
  1394.  
  1395.             prices valid until 30-Jun-1994
  1396.  
  1397.                Single User license
  1398.  
  1399.                  1 user           $20 US
  1400.  
  1401.                Multi-user site license
  1402.  
  1403.                Trumpet Winsock  will  be  charged  by  the number  of
  1404.             simultaneous users.
  1405.                The pricing structure for commercial users is thus
  1406.  
  1407.                  1-99 users          $20 US per user
  1408.                  100-499 users  $2000 US + $10 US per additional user
  1409.             over 100
  1410.                  500-999 users  $6000 US + $5 US  per additional user
  1411.             over 500
  1412.                  1000+ users    $8500 US + $2 US  per additional user
  1413.             over 1000
  1414.  
  1415.                  site restriction 10km radius (negotiable)
  1416.  
  1417.                Unlimited Commercial Site License
  1418.  
  1419.                  $10,000 US for first year.
  1420.                  subsequent years, 25% of unlimited  site license fee
  1421.             for that year.
  1422.                  site restriction 100km radius (negotiable)
  1423.  
  1424.                The pricing structure for educational users is thus
  1425.  
  1426.                  1-100 users         $20 US per user
  1427.                  100+      $2000 US
  1428.  
  1429.                  site restriction unlimited.
  1430.  
  1431.             Your site  license will  give you  support for  up  to 12
  1432.             months from  the date  of  purchase.   Such  support will
  1433.             include upgrades  and  bug fixes  within  that 12  months
  1434.             within  the   constraints  of   the   program's  existing
  1435.             capabilities.    Future  upgrades  will  be  25%  of  the
  1436.             original license fee  per annum.   Arrangements will also
  1437.             be made  for  conversion of  smaller  licenses to  larger
  1438.             ones.
  1439.  
  1440.  
  1441.  
  1442.                                         27
  1443.  
  1444.  
  1445.  
  1446.             Should  you  wish  to  obtain  the   Trumpet  Winsock  to
  1447.             distribute  with  other  programs,  you   should  make  a
  1448.             suitable offer to Trumpet Software  International, and it
  1449.             will be  considered.    Source  code  will  not  be  made
  1450.             available under any  circumstances, and  Trumpet Software
  1451.             International reserves the right not to  accept any offer
  1452.             which is not considered acceptable.
  1453.  
  1454.             Trumpet Software International
  1455.             GPO Box 1649,
  1456.             HOBART, TAS AUSTRALIA 7001
  1457.  
  1458.             FAX/Phone International  61-02-487049,    Australia  002-
  1459.             487049
  1460.